home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / DESKTOP / APPDOCK2.SPK / !AppDock2 / !Help < prev    next >
Text File  |  1996-09-28  |  15KB  |  294 lines
  1. > !AppDock2.!Help          Version 2.43     (28-Sep-96)
  2.  
  3. Sorry, there has been no development on this program for years. It is so
  4. far behind that everything but a complete re-write would be pointless. I
  5. have been planning to do this for years, but I never managed to. Nevertheless
  6. I might try one day...
  7.  
  8. New feature of version 2.42:
  9.   You can give the name of the dock file as parameter, so you can
  10.   have different dock files.
  11.   e.g. starting AppDock with "run ADFS::4.$.!AppDock ADFS::4.$.Docks.Dock1"
  12.   will use the specified file ADFS::4.$.Docks.Dock1 as the dock file. Save
  13.   operations then affect this file. If no parameter is given, the
  14.   behaviour is as before, i.e. the internal !Dock file is used.
  15.   
  16. New feature of version 2.41:
  17.   Adjust clicking on the dock window toggles the shortcut bar status
  18.   (i.e. removes/redisplays it).
  19.  
  20. New feature of version 2.40:
  21.   Pressing Alt+Ctrl+Shift brings the dock to the front, pressing the same
  22.   key combination again puts it to the back. While the dock is at the front,
  23.   it has a red border.
  24.   This feature can be disabled by choosing the menu item Prefs.Front.Never
  25.   (see below: 'RISC OS3' and 'Changes' for further details)
  26.   Clicking on the arrow icons of the dock or of the shortcut bar with Menu
  27.   instead of Select or Adjust switches to the very end (down/right arrow)
  28.   or to the very beginning (up/left arrow) of the dock or shortcut bar.
  29.  
  30. What is AppDock ?
  31. -----------------
  32.  
  33. This is an application dock program which is similar to backdrop utilities,
  34. in that it allows application icons to be arranged in a nice way and the
  35. applications to be started without having to deal with directory windows.
  36. The design is similar to the Application Dock that forms part of the NeXT
  37. Step system on NeXT computers.
  38.  
  39. A totally new feature is the ShortCut bar. It works similar to the
  40. application dock, but it stores ShortCuts for applications.
  41. You may define shortcuts for up to 20 applications. AppDock detects
  42. which application has the input focus and displays the shortcut
  43. definitions for the corresponding application. By clicking on one of
  44. the ShortCut buttons, the appropriate key combination is 'pressed' by
  45. the Application Dock.
  46.  You may edit the ShortCut definitions for each application. So, you
  47. may assign the ShortCut 'Find' and the key combination Ctrl-F4 to a
  48. button of the ShortCuts belonging to !Edit and if you click on the
  49. button while !Edit has the caret, the Find box is displayed.
  50.  
  51. How to use it:
  52.  
  53. 1.) the application dock
  54.  
  55. Simply drag an application or a directory on one of the square buttons on
  56. the vertical bar on the left (or right) side of the desktop.
  57.  
  58. If you dragged an application:
  59. * its icon is show on the button
  60. * double-clicking on it starts the application
  61. * dragging a file to it starts the application with the file given as
  62.   parameter
  63. * double-clicking with shift held down opens its directory
  64.  
  65. If you dragged a directory:
  66. (the same applies to a DOSDisc file or another image file if you are running
  67. RISC OS 3):
  68. * the name is shown on the button. 
  69. * as most names are to long to fit in one row, the application dock tries to
  70.   split the names at a sensible position, e.g. directory names as NewFiles
  71.   are split into 'New' and 'Files'.
  72. * double-clicking on it opens the directory
  73.  
  74. If you dragged a file to an application on the dock:
  75. * the application is started and the filename is given as parameter
  76.   (e.g. if you drag a file to the !Edit icon on the dock, !Edit is started
  77.   and the file is loaded).
  78.  
  79. You may define keyboard shortcuts for each entry in the dock, so that you
  80. are able to start them by one keystroke (if no other application intercepts
  81. the shortcut). Simply follow the submenu arrow of the second option of the
  82. main menu. The item is ticked if there is already a shortcut for the
  83. corresponding application/directory. Now select the key and the state of the
  84. control keys (none, Shift, Ctrl or Ctrl-Shift) and confirm the selection by
  85. clicking OK. You may cancel an existing shortcut by clicking on Off.
  86. Note that these shortcuts are not at all related to the shortcuts in
  87. the ShortCut bar.
  88.  
  89. Choosing 'Insert' causes one free button to be inserted before the button
  90. over which Menu was clicked.
  91.  
  92. Choosing 'Delete' causes the button over which Menu was clicked to be
  93. deleted.
  94.  
  95. Choosing 'Save all' from the menu saves the dock and the shortcuts defined
  96. in the ShortCut bar permanently (also save the preferences).
  97.  
  98. Note that if you have many applications in the dock, loading may take some
  99. time, as AppDock executes the !Boot file (or loads the !Sprites file if there
  100. is no !Boot file) of the applications in the dock (if they have not already
  101. be seen by the filer).
  102.  
  103.  
  104. 2.) The ShortCut bar
  105.  
  106. If the horizontal ShortCut bar is not on the screen, you may switch it on
  107. by obtaining the main menu of the apllication dock and choosing
  108. Prefs.ShortCuts.On
  109.  
  110. You may switch to edit mode by clicking Menu over the ShortCut bar and
  111. choosing Edit ... In the 'Edit shortcuts' window, you may browse
  112. through the defined applications by clicking the up/down arrow icons
  113. or you may define a new application by entering its name (the name
  114. shown in the Task Manager display, case sensitive !!) in the 'New
  115. application:' field and clicking the OK button next to it. Defined
  116. applications may be deleted by clicking the 'Delete' button.
  117.   Note that the ShortCut bar displays the shortcuts of the currently
  118. selected application.
  119.   By clicking Menu over one of the rectangular buttons of the ShortCut bar
  120. and following the submenu "ShortCut" you may edit the corresponding shortcut
  121. definition. This can also be achieved by Select-clicking on a shortcut
  122. button.
  123.   You may define the description of the ShortCut to be displayed on the bar
  124. by specifying it next to the text "Action:". Note that the maximum length
  125. for the description is 2 lines of 7 characters. You should leave a space
  126. where you want the lines to be split (e.g. 'Save file'). You may give the
  127. keystroke itself by positioning the caret in the small icon at the right of
  128. the text "ShortCut" and typing the corresponding key combination. You will
  129. hear the system bell and the key code will appear. Clicking on OK defines
  130. the shortcut.
  131.  
  132. Keystrokes which may be used:
  133.   
  134. Accepted keystrokes are generally all which have a RISC OS code:
  135.  * the function keys alone, with Ctrl, with Shift or with Ctrl-Shift
  136.  * all 'normal characters' from the keyboard
  137.  * Ctrl-A to Ctrl-Z (except Ctrl-U), Ctrl-[, Ctrl-], Ctrl-^, Ctrl-~
  138.  * arrow up/down, Ctrl + any of the arrow keys, Shift + arrow up/down
  139.  * some of the codes Alt+letter (not especially useful)
  140.  
  141. Additional keystrokes under RISC OS 3:
  142.  * Ctrl-U
  143.  * Delete, Copy, Shift-Copy, Ctrl-Copy
  144.  * arrow left/right (alone and + Shift)
  145.  
  146. Note that other keystrokes e.g. Ctrl-Shift-letter are not accepted, as
  147. they have no own character code. This is a pity as some programs (e.g.
  148. Impression and DeskEdit) make extensive use of Ctrl-Shift-letter
  149. combinations. However, to "send" such keystrokes to an application, much
  150. more efforts are necessary. This is likely to be added in later versions,
  151. now that the AppDockSpt module is part of the application anyway.
  152.  
  153. The shortcut definition are saved by choosing 'Save all' from one of
  154. the menues.
  155.  
  156.  
  157. 3.) RISC OS 3
  158.  
  159. Former versions of AppDock disappeared if the RISC OS3 pinboard was
  160. switched on. This bug is fixed now. In some intermediate versions the dock
  161. used to come to the front when Shift-F12 was pressed (like the icon bar).
  162. Unfortunately, this caused some problems, so this feature has been removed.
  163.  
  164. Version 2.40 and above offers the following feature instead:
  165. The dock can be toggled between front and back by pressing Alt+Ctrl+Shift.
  166. This feature only works if it is enabled by selecting the corresponding
  167. menu item (Prefs.Front.Alt+Ctrl+Shift). The setting is saved together with
  168. the other options.
  169.  
  170.  
  171. 4.) Upgrading from Version 1 to Version 2
  172.  
  173. Simply copy your old !Dock file to the !AppDock2 directory and it
  174. should work. In the !ShortCuts file there is a basic sets of shortcuts
  175. for !Draw, !Edit !DeskEdit, !Impression and !ArtWorks. You may extend
  176. these, of course.
  177.  
  178.  
  179. 5.) Giving the application away
  180.  
  181. You are strongly advised to distribute AppDock and to give it to any
  182. Archimedes owners you know !
  183.   If you give the application away, it is best to delete the !Dock file,
  184. as the one who receives it will probably have his applications stored in
  185. different places on his hard disc, so if you start the dock containing
  186. your old !Dock file, the dock will complain as it won't find the apps
  187. mentioned in the file.
  188.  
  189. (It is no problem to maintain the shortcuts, as AppDock is not concerned
  190. whether or not you have the applications mentioned in the ShortCuts file).
  191.  
  192.  
  193. This application is FREEWARE, i.e. it may be copied freely, provided that
  194. no part of it is deleted or changed and that it is not sold for profit.
  195.  
  196. Author:
  197.  
  198. Martin Wuerthner
  199. Jahnstrasse 18
  200. D-71116 Gaertringen
  201. Germany
  202.  
  203. Phone:+049-7034-928986
  204. Fax:  +049-7034-928988
  205.  
  206. e-mail: wuerthne@trick.informatik.uni-stuttgart.de
  207.  
  208.  
  209. Changes: Version 1.04: some bugs fixed
  210.          Version 1.05: now added Mode 20 icons
  211.          Version 1.06: o if a file is dragged to an application on the dock,
  212.                          the application is started with the filename as
  213.                          parameter
  214.                        o should now work better with RO3 as the window is
  215.                          re-opened if Ctrl-F11 is pressed
  216.          Version 1.10: o should now really work better with RO3 as the
  217.                          dock window doesn't disappear after returning
  218.                          from the command line
  219.                        o the dock comes to the front (like the icon bar)
  220.                          if Shift-F12 is pressed
  221.          Version 2.01: o ShortCut bar (automatic detection which app.
  222.                          has the input focus, editing facilities etc.)
  223.                        o new format (still reads version 1 !Dock files)
  224.                        
  225.          (Credits to Graham Hobson for his suggestion of the ShortCut bar)
  226.                          
  227.          Version 2.03: o Now accepts image files (e.g. DOSDisc files) and
  228.                          treats them as directories
  229.          Version 2.10: o Shift-F12-feature removed, as it interferes with
  230.                          the Pinboard (windows vanish if the Desktop is left
  231.                          using F12 while the dock is at the front).
  232.          Version 2.20: o Final version 2, posted to Newcastle
  233.          Version 2.21: o Small bug fix, posted to Newcastle
  234.          Version 2.30: o Wimp_Poll replaced by Wimp_PollIdle to reduce
  235.                          background processing time
  236.                        o Sorry for RISC OS 2 users who were confused because
  237.                          the RO2 sprite pool does not contain the 'up' and
  238.                          'down' arrow sprites which are used in the Edit
  239.                          Shortcuts window. They are now contained in the
  240.                          application's private sprite area
  241.          Version 2.31: o And I wondered why this new feature of RISC OS 3
  242.                          never worked ... I used the validation string N
  243.                          instead of KN, so you could not enter eg Ctrl-U as
  244.                          shortcut. This is now fixed, so under RISC OS 3
  245.                          you have some additional shortcuts (see above)
  246.          Version 2.32: o Now starts the !Run files of applications directly
  247.                          (starting the application itself does not work if
  248.                          it is within an image filing system like SparkFS)
  249.          Version 2.33: o If running under RO3, Filer_Boot is used instead of
  250.                          running the !Boot file of an application
  251.          Version 2.40: o Now detects whether it runs under RO2 or RO3 and
  252.                          uses the RO3 messages list if possible
  253.                        o Dock comes to front if Alt+Ctrl+Shift is pressed
  254.                          and if the feature is enabled. Can be put back by
  255.                          pressing the same combination again.
  256.                          The key press is detected by the AppDockSupport
  257.                          module. Under RO3 this is done via the poll-word
  258.                          feature, i.e. no extra null events are needed.
  259.                          Under RO2 the key status is checked using null
  260.                          events.
  261.                        o bug fixed: if shortcuts were switched off and the
  262.                          settings saved, the shortcuts could not be turned
  263.                          on again after re-loading the dock (gave error)
  264.                        o Clicking on the arrow icons with Menu switches to
  265.                          the very beginning or end of the dock/shortcut bar
  266.                        o In shortcut edit mode, clicking on a shortcut
  267.                          button with Select/Adjust no longer gives an error
  268.                          as it was the case with older versions. Instead,
  269.                          the corresponding 'Edit Shortcut' window is opened.
  270.          Version 2.41: o Adjust click on the dock toggles the shortcut bar
  271.                          status                         
  272.          Version 2.42: o allows dock file to loaded to be specified as command
  273.                          line parameter
  274.                        o bug fixed in error handler of save procedure (write-
  275.                          protected !Dock and !ShortCuts file no longer led
  276.                          to an infinite sequence of errors)
  277.          Version 2.43: o bug fixed in error handler of save procedure (having
  278.                          the application on a read-only medium led to an
  279.                          infinite sequence of errors)
  280.                        o attempt to make the program a bit more Style-Guide
  281.                          compliant - as a side effect it will only work under
  282.                          RISC OS 3 now
  283.  
  284. Features to add:       o Using outline fonts instead of system font
  285.                        o better user interface for shortcut bar edit operation
  286.                        o Dealing with Ctrl-Shift-letter shortcuts
  287.                          (e.g. Ctrl-Shift-I)
  288.                        o re-write everything in C (BASIC is ugly!)
  289.                        o allow files to be placed on the dock and allow them
  290.                          to be dragged to applications
  291.                        o allow dock entries to be dragged to a filer window
  292.                        o many more ...
  293.  
  294.